LKDOS MACHINE LANGUAGE SUBROUTINES 

The following information is for directly using the routines 
within the dos to control the diskdrive. 

They are useful in examining or changing data on the disk and 
aleo yon can create custom files and simulate random access 

iles etc. 

To access dos subroutines within the cartridge directly you 
must use machine language. 

To call these subroutines you must first turn ON the cartridge 
with a Call to address 98(dec). The cartridge is turned OFF bý 
a memory read at address 100(dec). 

You should also disable the interupts before entering and en- 
able them after you are done. 

EG: to access the cartridge. DI 
CALL 98 
CALL dos subroutine 
other user code 
Lp A, (100) 


RET 

DESCRIPTION OF USEFUL SUBROUTINES 

The addresses of these subroutines are on the TOL Oning pages 
The jump table of calls is used so that the addresses of the 
main routines doesn't change when a change or revision is made 
to the LKdos Eprom. Also because of the size of the dos, it was 
assembled in 2 modules . The second module uses the table to 
link to the first module. , 

SAVERF ~ Saves buffer to the current track and side as setup 
by TRACK or NEXTR. Disk should be spinning for 1 second before 
using this routine. You can load data to and from the buffer 
ueing the LDIR command in machine language. : 

LOADBF - Loads the buffer from the current track and side. 
No spinup necessary. 

TRACK - Restores the drive head to track O, then seeks the 
track held in curtrk. The number in curtrk is actually the 
block number, Even blocks are side 0, Odd are side 1. The 
track# is = INT(block/2) EG: Block 11 = track 5 side 1. 

NEXTR - Increments curtrk by one and moves the head to the 
nert UAGE or side . The drive should be running before this is 
called. 

INDIR ~ Sets the head on trackO and loads the directory trk 
Then searches for a file name matching the one the user has put 
at prognm. The senpa pointer holds the address of the file name 
if found. Errnu will contain 10 if the file wasn't found. Clear 
errnu before calling this. The file name should be put at 
prognm before T. this with spaces following the name to a 
full 10 characters if the name is short. , 

WFROT - Does 3/4 second spinup then checks for write protect 
sticker. If found it prints an error. This routine will stop 
your program on an error. Better to check it by manually. 

DECD - Prints decimal # held in tempi and accumulator. 

DOSER - This will prent a standard SYPE ETER the same way 
that the 2068 does. The HL register should ‘hold the start of the 
error message and the message should end with a period ‘.' 


SAVING AND LOADING PROGRAMS FROM MACHINE CODE 

You can directly access the main operating System. DY the ; 
following 4 subroutines. This will allow you to write or modify 
peed machine code programs to use the disk just as you can in 
aSic. i 

The reason you can’t access the dos by the same way basic does 
is that in basic,the program line contains all the information 
and the dos scans the line for formulas and file names. | 

The dos location ‘NmiF’ is used to tell the dos how it is 
peng called (NMI, Basic or from a machine code program). It 
a be loaded with 11(dec) before you call the following 
routines. 


SAVING FROM MC CONTINUED 


To Save an area or memory to disk from MC, you must give it a 
file name and transfer the file name to prognm. The file name 
should be a Code type but since there is no syntax enecns Pas 
any Bane and PA enson will work. You are not limited to .A B 
or . e es. 

Then cali the SV#1 subroutine. This will enter the file name 
in the directory and fill the dir workarea with free blocks to 
use for saving. 

Now load temp2 with the Length of the file and temp4 with the 
start address of the file. Then call SV#2 to finish the save. 
EG: to save a file named ‘test.ZZ’ start add 30000 length 10000 


Save DI disable int. 
CALL 98 turn on cartridge. 
LD HL,Name transfer file name 
LD DE,prognm to prognm 
LD ' 
LDI 
LD A,1i Set MC save. 
LD (NmiF),A 
CALL SV#i Save name . 
LD HL,30000 
LD (temp4) ,HL Set start address. 
LD HL, 10006 
LD eFene 2) hk Set length of save. 
CALL SV#2 Second a Stu duty 
= A, (100) Exit cartridge 
RET 

Name DEFM /test.ZZ / Name of file.Spaced out to 


10 characters 


The SV#1 mainroutine first calls the WPROT subroutine to see 

f the disk is protected. If it is,then it will terminate with 
a error. This will stop a MC program. 

If you dont want your MC Program to be hay at beim the best way 
around this is to find the address of the actual SV#1 routine 
in the eprom by reading locations 205 and 206 then aca.ts 3 to 

his to get past the WPROT call,then calling this new ad ress 
directly. This address must be calculated dynamicly because it 
may change with new revisions of eproms. 


LOADING A FILE FROM DISK 

„Loading a file from MC is similar to gaving. Just use LD#1 
instead of SV#1 and LD#2 instead of SV#2. The start and length 
still go into temp4 and temp2. The file name is also moved Into 
place the same way. 

You can poe 23728,100 the same way as a basic load, so that 
you dont halt your program with a File Not Found error. 


1t yon have need any futher info on how to access the dos, let 
me know. 
-LKdos was written on a 2068 using the ZEUS assembler. 
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LKDOS ADDRESSES AND SUBROUTINES FOR USER PROGRAMS 
OOQLO HAIE IE IE PE 1E AE AE HE HE 1E FE PE HE PE HE EFE HE E PE AE HE IE H HE ME E ME HE HE ME ME HE HE E mee 


00020 LOCATIONS USED BY THE DOS CALLS 


QOO4D KHEKKKEEREKEEREREEKERERHEEEREREREEEEEREE 


8194 Nmi ,User or Basic rag 


EQU 

EQU 8195 Drive select byte (17 

EQU 8202 Head speed for FD1770 

EQU 8203 Ram Disk bank# 

EQU 8204 Ram Disk bank address 

EQU 8220 Start of Disk workspace 
EQU wrkspc +84 2304 Start of track buffer 

EQU buffer +24 £322 Start of Actual data block 
EQU wrkspc +i 8305 Block # for head to seek IAG 
EQU wrkspc +4 8308 O if no error occured. 

EQU wrkspc +6 8310 Holds string from GTfil 
EQU wrkspc +20 $324 Used by DECDMP 

EQU wrkspc +21 8372s Usually length of file 
EQU wrkspc +23 8327 Start address of file 

EQU wrkspc #25 %329 temperary address 


wrkspc +30 3334 Holds Celi being used 


*#*** These are registers are saved with each track Exx* 


00190 lenth EQU buffer +14 3342 lenth of data block 


uffer +12 3340 address of data block m 


00200 Linenu EQU buffer +17 9345 Auto start Basic Line 
00210 Vofset EGU buffer +20 33428 Vars Offset (Total—Vars) „ 


00220 Totlen EQU buffer +22 %350 Total lenth of file — 
K E E E E E HE E E E E E E E E ME E E R E E E E R E E E E AE E E DE DE AE DE AE E A E A N ME E RE E E E E E 
Put eee een 


1984 ~ 1960 
FER K RE RE E E A A EKER ERE E E E E K E E E e E E E E 


Data length 
5090 Double Density Controller 


Pe Pete Density Controller 
HEKEKEKEKKKEKRRKREKREEEE 


This is the LKdos main subroutine jump table . Each Call 
is 3 bytes apart. These addresses are unaffected by any 
Changes or revisions made later to the Dos. 

COZSO HRKKEKKEHRKEKEEKRKKKEKE 


00260 STAR 


TS 
00270 -- CALL 


00570 SV#2 


Caa Cu Ca Ca Cat Car Cag Car Cos Cas Coa C Caa Ca Caa Coa Cus Ca Cas Caa Cag Cua Cu Cua Cu Caa Cu Cus Cur Cas 
IREE.: a a a o a e b v Da o e o D s Sas e Bia e Da o Da 2 Da o Din o D è Da e n + Gen a Don e n 2 Boa a Boe t Die a Doa a n a Gn + B 2 A t) 


crcesv 120 Save the buffer to the disk 


loadbf 123 Load the Buffer from the disk 
trac 126 Restore to TrkO then seek curtrk 
nextrk 129 Increment disk head 1 trk or sid 
indir 132 Check dir for file (in prognm) 
movdr 135 Move cell to dirwka 

emdck 138 Check command syntax 

Endoln 141 Move CHADD to end of basic line 
Evalu 144 Evaluate Numeric formula 

nofil 147 No file error 

WPROt 150 Check for protect sticker 

zero 153 Restore blocks used by cell 
GTfil 156 Evaluate Pr Eng , Put in prognm 
ROMS 159 Check for spectrum rom 

newet 162 Put new entry in dir 

decdm 165 Print tempi in decimal 

tranok 168 Final routine for save 

DOSOP 171 Close the disk channel 

Doserr 174 Print Error HL holds Messag 
clirbf 177 Clear buffer 

encdbf 180 Encode the buffer with Addresses 
vserch 183 Look for Arrays 

GTOUT 186 Exit cartridge 

Grow 189 Insert space in program 

Shrink 192 delete space in program 

Fatal 195 Cat data error 

Lsubr 198 First half of User load command 
LDdata 201 second hal 

Ssubr 204 First half of User save command 


SMEM 207 second half 


NOTE- Most of the cartridge ram is used by the dos and ex-bas 


Operating syste 


storage . 


I 


fo 


m, But the merge buffer can be used for temp 
llows the data buffer and is 1200 bytes long. 


